Create and Apply a Transform

A Transform allows you to change the display of the response from the API. When using a transform, you can:

• Map the following:
  • One input to one output
  • Outputs only
  • Multiple inputs to one output
  • One input to multiple outputs
• Only map to the same data type. For example, you can only connect a string property to another string property. If the data types do not match, you will receive an error during Preview.
• Write Apache Groovy code in the Code Editor instead of manually adding transforms.
• Upload JSON/SOAP/XML files for your input/output.

Complete these steps to create and apply a transform:

1. In the directory carousel, click the project for which you want to create and apply a transform.
2. In the directory, click the application for which you want to create and apply a transform.
3. Click the Integrate tab.
4. Click the Services sub-tab, and then select the service provider from the drop-down list.
5. Click to expand the services until the following screen displays:

6. Click the Response Edit icon, and the Transforms screen displays:

Note: If No Input Loaded or No Output Loaded displays, click Load, and then upload a mapping. See Data Mapper for instructions on how to upload a mapping.

7. Click the Add button on the output.

The Transforms dialog box displays:

Note: If there are existing transforms, a list of the existing transforms displays. Click the transform to select an existing one.

8. Click Add New, and the Transform Setting dialog box displays:

9. Enter a name for the transform into the Name field.
10. Complete one of the following actions:
• To transform one input to one output, click Add Input Parameter, and then click Add Output Parameter.
• To transform one or multiple outputs, click Add Output Parameter for each output.
• To transform multiple inputs to one output, click Add Input Parameter for each input, and then click Add Output Parameter.
• To transform one input to multiple outputs, click Add Input Parameter, and then click Add Output Parameter for each output.
11. Click the Editor tab and configure the input/output parameters.

Note: The number of available input/output blocks correspond with your selection in step 10. For example, if you selected one input parameter and three output parameters, you will see the following:

An example expression to transform the output to uppercase is as follows:

An example expression to transform the output times 10 is as follows:

12. Click Save.
13. Map the input and output as necessary. See Data Mapper for instructions on how to map an input to an output.

Note: If you are transforming only outputs, you do not need to map the input and output.

14. Click the Add button at the beginning of the output if you are transforming the output only or at the end of the output connection if you are mapping inputs and outputs:



The Transforms dialog box displays with the transform that you just created displaying in the existing transform list.



15. Click the transform that you created, and then click Apply. The transformed output is now identified with a purple circle.





16. Click the purple circle, and the Transforms dialog box displays:

17. From the Output drop-down list, select the transform that you created.
18. Click Apply.
19. Click Save.